home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / dateimanager / mtool / docs / mtool_i.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  40KB  |  899 lines
  1. @database "MultiTool II V2.0"
  2. @node MAIN "Manuale per MultiTool II V2.0  
  3. 1993 di Boris Jakubaschk"
  4.                                   MultiTool II
  5.                                       V2.0
  6.                                    03.08.1994
  7.                               - Versione Shareware -
  8.                                      MANUALE
  9.              CONTENUTI:
  10.              @{"    Per che non ama leggere i manuali...           " link NoDocs}
  11.              @{" 1. Introduzione                                   " link Intro}
  12.               @{"  1.1 Legal matters     " link Legal} @{"  1.2 Shareware         " link Share}
  13.               @{"  1.3 Ringraziamenti    " link Thanks}
  14.              @{" 2. Installazione                                  " link Install}
  15.              @{" 3. Preferenze                                     " link Prefs}
  16.               @{"  3.1 Generali          " link PR_general} @{"  3.2 Programmi         " link PR_progs}
  17.               @{"  3.3 Menu              " link PR_menu} @{"  3.4 Icone             " link PR_icon}
  18.               @{"  3.5 File types        " link PR_types} @{"  3.6 Elenco device     " link PR_devs}
  19.               @{"  3.7 Elenco Azioni     " link PR_action}
  20.              @{" 4. Uso di MTool                                   " link Usage}
  21.               @{"  4.1 Lista files       " link US_dirs} @{"  4.2 Copia, Cancella..." link US_copy}
  22.               @{"  4.3 Selezioni         " link US_select} @{"  4.4 Archivia          " link US_archiv}
  23.               @{"  4.5 Analizza / esegui " link US_analyze} @{"  4.6 Menu              " link US_menu}
  24.               @{"  4.7 Icone             " link US_icon} @{"  4.8 Altre features    " link US_rest}
  25. Note: I couldn't reach Marco Mellia to ask him for an update of the manual
  26. and the catalogs. So this manual describes MTool V2.0. For information about
  27. the new features of MTool V2.1 please consult one of the other manuals or
  28. the history files.
  29. @endnode
  30. @node NoDocs "Per chi non ama leggere i manuali...
  31. ...   Parler
  32.   di  alcune  cose  importanti.   Altrimenti  sar
  33.   costretto a
  34. rispondere alla stessa domanda pi
  35.  e pi
  36.  volte!
  37. - MTool  
  38.  shareware.  Se lo usi frequentemente, dovresti pagare 15 dollari
  39.   per   la registrazione.  Cos
  40.  facendo riceverai un  keyfile  che liberer
  41.   tutte le capacit
  42.  di MTool anche per le versioni future.
  43. - Sei libero  di distribuire a chi tu vuoi MTool, a patto di non farti dare
  44.   denaro in cambio.
  45. - La  prima  linea  di  ogni elenco di file 
  46.   scritta in  grassetto perch
  47.  possibile  usare  i tasti cursore per muoversi all'interno dell'elenco.
  48.   Quella evidenziata in grassetto 
  49.  quella al momento selezionata.
  50. - L' accento  grave ("`", sotto  il tasto ESC) cambia l' elenco dei 
  51. device
  52.   in una lista alternativa (configurabile).
  53. - Premendo spazio si cambia la finestra della lista dei files attiva.
  54. - Ci sono dei gadgets invisibili all'estrema destra e sinistra: servono per
  55.   risalire indietro nelle directories
  56. - "Iconizza"  nel  menu  Progetto  chiude  la  finestra di MTool. Si riapre
  57.   premendo i tasti Ctrl-Alt-"<".
  58. Se non hai capito una parola di ci
  59.  che c'
  60.  scritto...  pensa che forse 
  61. caso di leggere l'intero manuale ;-)
  62. @endnode
  63. @node Intro "Introduzione"
  64. 1. Introduzione:
  65. Benvenuto all'uso di MultiTool II V2.0!
  66. MTool 
  67.  un programma che ti sar
  68.  di grande aiuto nella gestione di dischetti
  69. e  hard  disks:  per installare programmi, per cambiare l'organizzazione dei
  70. tuoi dati o per esempio per cancellare files.
  71. Questi  programmi  vengono di solito chiamati directory utilities.  Lavorano
  72. tutti  allo  stesso  modo:   ci  sono  due  elenchi  ciascuno contenente una
  73. directory.  E' possibile selezionare file e sotto directory, combinare delle
  74. azioni  su quelli selezionati premendo dei gadgets:  copia, cancella, mostra
  75. il disegno, eccetera...
  76. MTool  ha  alcune particolarit
  77.  che lo rendono diverso da altri programmi di
  78. questo tipo:
  79.   stato  disegnato in  modo da  lasciare pi
  80.   spazio possibile all'elenco
  81.   dei file.
  82. - I gadgets delle azioni possibili sono in mezzo alle liste dei file.
  83.   Rispetto ad altri programmi, ce ne sono meno, ma molto pi
  84.  efficienti.
  85. - Un  altro elenco  
  86.  presente 
  87. sopra  i comandi  disponibili  e pu
  88.   essere
  89.   modificato  a  piacere  attraverso  differenti  opzioni.   Per esempio pu
  90.   servire  per  selezionare  le  directories correnti, o per eseguire alcuni
  91.   comandi configurabili dall'utente.
  92. - Il  mio programma  
  93.  conforme  all' "user  interface  style guide".  MTool
  94.   necessita OS2.0  (V37.xx).   Nuove versioni  del  sistema  operativo  sono
  95.   automaticamente utilizzate  con profitto (ad esempio la localizzazione, il
  96.   busy pointer modificabile sotto 3.0).
  97. - Nonostante  l' apparente  complessit
  98.   del  programma,  MTool  pu
  99.   essere
  100.   installato molto  facilmente, attraverso un editor dei settaggi dove tutto
  101.  essere cambiato con il mouse.
  102. Sperio  che  MTool  ti sia utile nel manipolare i tuoi dati sparsi nell'hard
  103. disk :-)
  104.                                             Boris Jakubaschk
  105. @endnode
  106. @node Legal "Legal matters"
  107. 1.1 Legal matters:
  108. L'autore non pu
  109.  essere considerato responsabile dell'esattezza o precisione
  110. di  questo  manuale  [tantomeno  il  traduttore  NdT  :) ] e/o del programma
  111. descritto.   Qualunque danno direttamente o no imputabile all'uso o abuso di
  112. questo manuale e/o programma 
  113.  da imputarsi solamente all'utente stesso.
  114. MultiTool II, 
  115.  Copyright 1992 Boris Jakubaschk. All rights reserved.
  116. Questo  programma  
  117.   SHAREWARE,  per  cui  se viene usato frequentemente, 
  118. obbligatorio  pagare  una  quota  di  registrazione  pari  a  US15$ (vedi il
  119. prossimo  capitolo  per  i dettagli).  Tuttavia, questo programma pu
  120.  essere
  121. liberamente  distribuito purch
  122.  la documentazione e gli eseguibili rimangano
  123. intatti  e  inclusi  nella  distribuzione.   Non 
  124.  possibile chiedere alcuna
  125. somma di denaro in cambio.
  126. E' possibile tuttavia:
  127. - Dare MTool agli amici.
  128. - Scaricarlo  in qualunque  BBS o network  dove l'utente non deve pagare per
  129.   fare dei download (FIDO, FTP).
  130. - Inluderlo in collezioni non commmerciali di software PD.
  131. Nell'archivio di MTool dovresti aver trovato i seguenti files:
  132. MTool            - Il programma stesso
  133. MTool.info       - la sua icona
  134. MTPrefs          - l'editor dei settaggi
  135. MTPrefs.info     - la sua icona
  136. ENVARC/MTool/MTool.Prefs
  137.                  - file di esempio settaggi
  138. Catalogs/#?      - file dei cataloghi per differneti lingue (OS2.1+)
  139. MTool_x.guide    - questo manuale. La "x" indica diverse lingue
  140. MTool_x.history  - Storia di MTool
  141. MTool_x.desc     - Breve descrizione di MTool
  142. Localesource/#?  - Sorgenti per il  supporto della "locale" in modo da poter
  143.                    creare i propri cataloghi.
  144. TUTTI I FILES DEVONO ESSERE RIDISTRIBUITI IMMUTATI!
  145. Se  si  
  146.   in  grado  si  tradurre i file della locale per MTool in un altra
  147. lingua, per favore fatelo e mandatemi il risultato.  I sorgenti per fare ci
  148. si  trovano  in  "Localesource/...".   Per  favore,  tradurre  solo  il file
  149. MTool_d.ct.  MTool.cd deve essere immutato.
  150. MTool  
  151.   stato  sviluppato  in  un  periodo  di  un  anno e dovrebbe essere
  152. sufficientemente  stabile.   D'altra parte non esiste alcun grande programma
  153. senza  bachi...   Se  durante l'uso di MTool incontrassi dei bachi, ti sarei
  154. lieto se me li comunicassi.  E' l'unico modo che ho per eliminarli!
  155. Scrive a:                  Boris Jakubaschk
  156.                            Neue Stra
  157. e 14/1
  158.                            70186 Stuttgart
  159.                            Germany
  160. O manda un msg a:  E-mail  Boris@alice.tynet.sub.org
  161.                    Fido    Boris Jakubaschk, 2:246/1115.2
  162. O semplicemente chiamami:  ++49 711 462989
  163. @endnode
  164. @node Share "Shareware"
  165. 1.2 Shareware:
  166. Questa  versione  di  MTool  
  167.   limitata.  Inizialmente compare un requester
  168. "Please  register"  e  alcune funzioni di MTool sono visibili ma non possono
  169. essere usate:
  170.  il requester iniziale che non si pu
  171.  chiudere finch
  172.   chiocciolina non 
  173.  arrivata alla fine del suo cammino...
  174. - Non 
  175.  possibile creare automaticamente le icone.
  176. - Non 
  177.  possibile lavorare direttamente sui files contenunti negli archivi.
  178. - Appwindow (la possibilit
  179.  di inserire icone nelle finestre di MTool) non
  180.   funziona.
  181. Non appena mi giunger
  182.  la tua richiesta di registrazione, ti mander
  183. keyfile.   Questo  rimuover
  184.   tutti  i  limiti  della  versione  limitata  e
  185. funzioner
  186.  anche per le successive versioni di MTool.
  187. Per favore, supporta nuove versioni di MTool registrandoti.
  188. Il  prezzo  
  189.  di 15$.  Non ci sono eccezioni (beh, se sei un disoccupato con
  190. cinque figli pu
  191.  essere che ci pensi su...)
  192. Volendo  puoi  pagare  l'equivalente  di 15$ in altre monete.  Non appena mi
  193. giungeranno  i  tuoi soldi, spedir
  194.  il keyfile in forma uuencodata via posta
  195. eletronica o in un dischetto.
  196. Preferisco  ricevere soldi in denaro.  So che si corrono dei rischi mandando
  197. soldi  in  lettere,  ma  
  198.   il modo pi
  199.  facile per me di ottenere dei marchi
  200. tedeschi (s
  201. , sono tedesco :-)) Anche Eurocheques sono benvenuti, ma solo in
  202. marchi tedeschi!  Altre valute sono molto difficili da cambiare :)
  203. Manda tutto a:  Boris Jakubaschk, Neue Stra
  204. e 14/1, 70186 Stuttgart
  205.                 Germany
  206.             o:
  207.                 Boris Jakubaschk, Im 
  208. schle 28, 78727 Oberndorf
  209.                 Germany
  210. @endnode
  211. @node Thanks "Ringraziamenti"
  212. 1.3 Ringraziamenti:
  213. MTool  
  214.  stato sviluppato con il prezioso aiuto di amici e altre persone che
  215. mi hanno comunicato Bugs e nuove idee.  Grazie a tutti!
  216. In particolare:
  217.   - A coloro che hanno tradotto i catalogs e il manuale:
  218.  Adam Sj
  219. gren (Dansk catalog)
  220.  Volker A. Graf (Dansk manual)
  221.  Christopher J. Ellerbeck (English, V1.5)
  222.  Arian T. Kulp (English, V2.0)
  223.  Pascal Aubert (French catalog)
  224.  Lionel Vintenat (French manual)
  225.  Marco Mellia (Italiano)
  226.  Thorkild Stray (Norwegian)
  227.  Garcia (Spanish)
  228.  Mikael Silfver (Swedish catalog)
  229.  Johan Billing (Swedish manual)
  230.  Vlado Saffa (Slovak)
  231.  Osma Ahvenlampi (Suomi)
  232.  H. Huisman (Dutch manual)
  233.  Rembrandt de Witt (Dutch catalog)
  234.   - Andreas Baum Per il suo MultiIndicator
  235.   - Stefan Boberg per LHA
  236.   - Matt Dillon per il compilatore C DICE
  237.   - Holger Trapp per la sua icona stile MagiWB per MTool
  238.   - Stefan Becker per Toolmanager, e il permesso di copiare la sua
  239.     interfaccia utente per il suo editor delle preferences
  240.   - Jan van den Baard per GadToolsBox
  241.   - Markus M
  242. nig per aver risolto i primi problemi con me
  243.   - Markus Nerding (MAXON) per avermi spedito il RKRM Libraries
  244.   - Andreas Baum, Jens B
  245. nisch, Matthias Hank, Bernd Johannes,
  246.     Harald Schneider, Mikael Silfver, Holger Trapp and Erik Wende (in
  247.     ordine alfabetico), per il prezioso lavoro di beta tester.
  248.   - Johan Billing, Rolf Damm, Marc Duponcheel, Christopher J. Ellerbeck,
  249.     Jos
  250.  Garcia, Jan Holler, Brian Jacobson, Christian Krenner,
  251.     Reinhard Kunter, Markus M
  252. nig, Marc Necker, Robert Peter Poole,
  253.     Jochen Schiller, Harald Schuler, Thorkild Stray und Gregor
  254.     Wenkelewsky, che mi hanno aiutato nella scoperta di bugs e mi hanno
  255.     suggerito nuove cose.
  256. @endnode
  257. @node Install "Installazione"
  258. 2. Installazione:
  259. Nella  distribuzione  standard di MTool, troverai uno script che si occuper
  260. dell'installazione  facilmente  e velocemente sul tuo sistema.  Per usarlo 
  261. necessario  avere  l'istaller  della  Commodore.   Se non lo possiedi o vuoi
  262. installare MTool manualmente, per favore, segui le istruzioni sotto:
  263. - Crea una directory per il file dei settaggi:
  264.   MAKEDIR ENVARC:MTool
  265.   Se sei gi
  266.  registrato a MTool, devi mettere il keyfile in questa
  267.   directory.
  268. - Scegli o crea una directory per il programma principale. Copiaci "MTool" e
  269.   "MTool.info". O se preferisci usare il Workbench, muovi l'icona
  270.   direttamente nel cassetto selezionato.
  271. - Adesso  puoi copiare  "MTPrefs" e "MTPrefs.info" in una directory compresa
  272.   nel  path  di  sistema,  ad esempio SYS:Tools.  Oppure puoi mettere questi
  273.   file  in  SYS:Prefs.   A  questo  punto  devi cambiare i nomi in "MTool" e
  274.   "MTool.info".   Usando  il  Workbench devi trascinare l'icona nel cassetto
  275.   prefs e usare"Icone/Rinominare" ("Icons/rename") dal menu.
  276. - Se  usi  una versione  del S.O.  maggiore o uguale al 2.1, devi copiare la
  277.   directory "catalogs" in "Locale:catalogs".  A questo punto tutti i i testi
  278.   verranno mostrati nel linguaggio da te preferito (se supportato).
  279. - I  fonts,  i  manuali,  e  i sorgenti dei cataloghi non sono necessari per
  280.   l'uso di MTool, ma probabilmente utili...
  281. - A  questo  punto  puoi  resettare  il  tuo Amiga o copiare il contenuto di
  282.   ENVARC:MTool  in  ENV:MTool.   Adesso  puoi  continuare l'installazione di
  283.   MTool tramite il programma di MTPrefs
  284. @endnode
  285. @node Prefs "Preferenze"
  286. 3. Preferenze:
  287. E' necessario fare alcuni piccoli settaggi prima di poter usare MTool per la
  288. prima volta.  Per fare ci
  289. , lancia il programma MTPrefs per prima cosa.
  290. Comparir
  291.   una  finestra  con  una  grande  listview  all'interno.  Sopra la
  292. listview  c'
  293.   un  gadget  di  tipo  cycle che permette di selezionare quali
  294. elementi  saranno presenti nella listview.  Dovresti vedere "Miscellaneous".
  295.  quello che si serve adesso.
  296. Sulla sinistra vedi alcuni altri pulsanti per la manipolazione degli oggetti
  297. nell'elenco.  Sono disabilitati quando 
  298.  selezionato "Miscellaneous".
  299. I  tre  pulsanti in fondo alla finestra sono usati per uscire dal programma.
  300. Scegliendo "Salva", renderai i cambiamenti permanenti.  Con "Usa" resteranno
  301. validi   fino   al   prossimo  reset  e  "Cancella"  non  memorizzer
  302.   alcun
  303. cambiamento.
  304. Clickando due volte in uno degli oggetti della lista, o selezionandolo e poi
  305. premendo  "Edita",  si aprir
  306.  un'altra finestra.  E' qui che devi inserire i
  307. tuoi settaggi personalizzati!
  308. @endnode
  309. @node PR_general "Generali"
  310. 3.1 Generali:
  311. Percorsi:
  312. - locazione LHA : Inserisci qui il nome e il percorso completo del programma
  313.                   LHA nel tuo sistema. Se LHA 
  314.  gia in una directory presente
  315.                    nel path del sistema, 
  316.  sufficiente inserire  "LHA"
  317.                   Se non inserisci nulla, MTool non sar
  318.  in grado di
  319.                   adoperare gli archivi di tipo LHA.
  320. - Def. Path 1   : MTool pu
  321.  mostrare due directories nelle due finestre
  322.                   principali direttamente all'avvio del programma.
  323.                   Qui devi inserire quella che verr
  324.  posizionata nella
  325.                   finestra di sinistra.
  326. - Def. Path 2   : Idem come sopra ma per la finestra di desta.
  327. - Drawer Icon   : Pi
  328.  avanti nel manuale parleremo di come generare delle
  329.                   icone. Qui 
  330.  necessario inserire il file icona che MTool
  331.                   user
  332.  per la creazione dei cassetti. Per adesso non puoi
  333.                   inserire nulla perch
  334.  non c'
  335.  ancora nessun oggetto
  336.                   icona definito.
  337. Schermo & Flags:
  338. - Tipo schermo  : Permette di decidere se MTool aprir
  339.  la sua finestra
  340.                   sullo schermo del Workbench, in uno publicco, o su
  341.                   un nuovo schermo.
  342. - Nome schermo  : Se la finestra di Mtool non si apre sul Workbench,
  343.                   qui si deve inserire il nome dello schermo che MTool
  344.                   aprir
  345. - Pienoschermo  : se selezionato, MTool user
  346.  tutto lo spazio disponibile
  347.                   sullo schemro per aprire la sua finestra, senza il gadget
  348.                   di ridimensionamento. Non 
  349.  applicabile allo schermo del
  350.                   Workbench.
  351. - AutoDir       : Se 
  352.  selezionato, MTool si accorge se i dischi sono
  353.                   cambiati e aggiorna di conseguenza l'elenco dei file
  354.                   mostrati.
  355. - Chiudi = Hide : Solitamente MTool esce se si chiude la finestra
  356.                   direttamente. Selezionando questa opzione, MTool invece
  357.                   chiuder
  358.  la sua finestra rimanendo per
  359.  in memoria e
  360.                   pronto a ritornare attivo premendo i suoi hotkey
  361.                   (Ctrl-Alt-"<"). E' possibile cambiare gli hotkey attraverso
  362.                   i tooltypes dell'icona di MTool.
  363. - Lunghezza...  : Questo e tutti i gadget  sono usati per definire le
  364.                   opzioni di copia, cancellazione, spostamento dei files.
  365.                   Sono messi nello stesso ornine del requester di copia di
  366.                   MTool. Vedi il capitolo 4 di questo manuale per ulteriori
  367.                   dettagli.
  368. Screenmode:
  369. Si   aprir
  370.   un  screenmode  requester,  dove  
  371.   possibile  selezionare  la
  372. risoluzione, numero di colori, e il tipo di dysplay mode che MTool user
  373. il suo schermo.
  374. Dimensioni Finestra:
  375. Comparir
  376.   una  finestra  vuota,  
  377.   possibile  muoverla,  ridimensionarla a
  378. proprio piacimento.  Una volta trovata la posizione e dimensione desiderata,
  379. chiudila semplicemente.  D'ora in poi MTool aprir
  380.  la propria finestra nella
  381. stessa posizione e delle stesse dimensioni.
  382. Gadget Font:
  383. Puoi  selezionare il nome del font e la sua dimensione che verr
  384.  usato per i
  385. gadgets.
  386. List Font:
  387. Idem, ma per le listview.  Solo font non proporzionali.
  388. Se stavi leggendo il manuale sequenzialmente fino a qui, e hai messo a posto
  389. tutte  le  cose  fin qui indicate, pui uscire della preferences e savare con
  390. "Salva".   Lancia  MTool  adesso.  Il suo uso 
  391.  descritto nel @{"Capitolo 4"
  392. link  Usage}  di  questo  manuale.  Il seguente paragrafo invece descrive il
  393. settaggio  avanzato della preferences.  E' inutile leggerlo se prima non hai
  394. provato ad usare MTool.
  395. @endnode
  396. @node PR_progs "Programma"
  397. 3.2 Programma:
  398. Se  premi  il  gadget  "Tipo  Oggetti", questo cambier
  399.  da "Miscellaneous" a
  400. "Programma".   Avrai  notato  a questo punto che i gadget sulla sinistra non
  401. sono  pi
  402.   disabilitati.   Puoi  usarli  per aggiungere nuovi elementi nella
  403. lista,  per  rimuoverne  altri,  per spostarli su e gi
  404. , o per copiarli.  E'
  405. anche possibile metterli in ordine alfabetico.
  406. Crea  un nuovo elemento premendo "Nuovo".  Selezionalo e cambia il nome (per
  407. esempio in "Bits di protezione" semplicemente scrivendo il nome nello spazio
  408. disponibile sotto la list view.
  409. Adesso selziona "Edita".  Comparir
  410.  un requester con il nome dell'oggetto da
  411. te  precedentemente  selezionato in cima.  Puo cambiare il nome dell'oggetto
  412. con  questo.  Lo slider sotto serve per scorrerre l'elenco degli oggetti gi
  413. presenti nell'elenco.
  414. Programma  :  Nome e percorso del programma.  Parametri :  Inserisci qui gli
  415. argomenti del comando.  Se devi inserire dei
  416.              parametri standard (ad esempio delle opzioni) scrivili
  417.              esattamente come se stessi lanciando il programma da shell.
  418.              Paramentri invece che possono cambiare (ad esempio nome e
  419.              percorso) inseriscili come "%s" (includendo le virgolette).
  420. Def.Parm. 1: Qui puoi selezionare cosa verr
  421.  usato da MTool per rimpiazzare
  422.              il primo "%s" nella stringa dei parametri.
  423. Def.Parm. 2: Idem per il secondo "%s".
  424. Def.Parm. 3: Idem per il terzo "%s".
  425. So  che  questo  modo  di definire dei programmi-oggetto esterni non 
  426.  molto
  427. facile da capire.  Forse un esempio pu
  428.  essere di aiuto:
  429. 1.  Bits di Protezione:
  430. Programma  : C:Protect
  431. Parametri  : "%s" %s
  432. Def.Parm. 1: Source File Name
  433. Def.Parm. 2: Request
  434. Def.Parm. 3: None
  435. Se  adesso  questo programma-oggetto 
  436.  selezionato (come fare ci
  437.  spiegato
  438.   avanti),  comparir
  439.   un  requester  per  richiedere  un  argomento.  Il
  440. risultato  di  questo  riequester  andr
  441.   a  sostituire  il primo "%s" nella
  442. stringa dei parametri.  A questo punto MTool creer
  443.  un elenco di comandi per
  444. ciascun  elemento selezionato della lista dei files attiva, e rimpiazzer
  445. secondo  "%s"  con  ciascun  elemento di questa lista.  Se, per esempio, hai
  446. selezionato  i  files "startup-sequence" e "user-startup" nella directory s:
  447. del  tuo  sistema,  e  quindi richiamato questo programma-oggetto e inserito
  448. "+S"  nel requester presentato da MTool, Mtool creer
  449.  ed eseguir
  450.  i seguenti
  451. comandi:
  452.   C:Protect "S:user-startup" +S
  453.   C:Protect "S:startup-sequence" +S
  454. 2. Editor:
  455. Program    : SYS:XCli/EDC
  456. Parameters : "%s" -Sticky
  457. Def.Parm. 1: Source File Name
  458. Def.Parm. 2: None
  459. Def.Parm. 3: None
  460. Questo  esempio mostra come richiamare il CygnusEd da MTool.  Questo tipo di
  461. comando  oggetto,  eliminando  il parametro "-Sticky" va bene anche per quei
  462. programmi che si occupano di mostrare file, disegni, suonare moduli ...
  463. 3. Copy:
  464. Program    : C:Copy
  465. Parameters : "%s" "%s"
  466. Def.Parm. 1: Source File Name
  467. Def.Parm. 2: Dest Path
  468. Def.Parm. 3: None
  469. Questo  
  470.   un  comando  oggetto  alternativo al gadget Copy di MTool.  Non 
  471. molto  utile,  ma  pu
  472.   dare  un  idea  di come MTool concepisca i programmi
  473. oggetto.
  474. @endnode
  475. @node PR_menu "Menu"
  476. 3.3 Menu:
  477. Ormai  la disposizione dei gadget nel requester non dovrebbe pi
  478.  stupirti...
  479. Ce ne sono solo due nuovi:
  480. Shortcut   : Serve per inserire il tasto che servir
  481.  per richiamare il
  482.              programma definito sotto, ovviamente premuto insieme al tasto
  483.              Amiga di destra.
  484. Programma  : 
  485.  il programma oggetto che sar
  486.  richiamato da questo menu.
  487. I nomi degli oggetti qui definiti serviranno come possibili scelte nel menu
  488. strumenti di Mtool
  489. Esempio:
  490. Nome oggetto: Copia Files
  491. Shortcut    : Y
  492. Programma   : Copy
  493. Questo  inizializza  una  entry  nel  menu chiamata "Copia Files".  Il tasto
  494. shortcuts  
  495.   visualizzato alla destra dell'entry.  Selezionandolo dal menu,
  496.  chiamato il programma oggetto "Copy" gi
  497.  definito.
  498. @endnode
  499. @node PR_icon "Icone"
  500. 3.4 Icone:
  501. Selezionandolo si aprir
  502.  un file requester, da quale 
  503.  possibile selezionare
  504. un file di tipo icona che verr
  505.  usato per il nome in uso attualmente.
  506. Esempio:
  507. Nome oggetto: Drawer
  508. File icona  : SYS:System.info
  509. "System.info" 
  510.  il simbolo dei cassetti (directories...).  Adesso puoi usare
  511. questo   oggetto   per   definire   una   icona   per   i   cassetti   (vedi
  512. miscellaneous->paths).
  513. @endnode
  514. @node PR_types "File Type"
  515. 3.5 File Type:
  516. Questa 
  517.  una possibilit
  518.  molto importante e utilie di MTool, e pu
  519.  essere un
  520.   complicata  da  comprendere...   devi dire a MTool come riconoscere
  521. diversi  tipi  di  file  tra loro.  In seguito 
  522.  possibile dire a MTool come
  523. comportarsi una volta riconosciuti questi file...
  524. Il  gadget a destra "Riconosci" 
  525.  usato per selezionare il modo in cui MTool
  526. cercher
  527.  di riconoscere il file:
  528. - Pattern     : La stringa di riconoscimento sar
  529.  usata come un patttern
  530.                 del DOS e comparata con il nome del file per il test.
  531. - ASC-Filter  : La stringa di riconoscimento sar
  532.  comparata byte a byte con
  533.                 l'inizio del file. 
  534.  possibile mettere dei punti di domanda
  535.                 come caratteri jolly.
  536. - HEX-Filter  : I due carattari della stringa di riconoscimento saranno
  537.                 usati come codici esadecimali e confrontati con il primo
  538.                 byte del file. Anche in questo caso i punti di domanda
  539.                 servono come caratteri jolly.
  540. - ASCII Text  : MTool cerca di capire se il file 
  541.  formato da caratteri ASCII.
  542.                 in questo caso la stringa di riconoscimento non viene usata.
  543. - Unknown File: Se i files non appartengono a una delle classi sopra,
  544.                 saranno riconosciuti come "unknown" (non riconosciuti :-)).
  545.                 Anche qui la stringa di riconoscimento non viene usata.
  546. Ci sono tre tipi di utilizzo per il riconoscimento dei files.
  547. - MTool pu
  548.  mostrare il tipo riconosciuto quando si seleziona "Analizza".
  549. - MTool pu
  550.  eseguire un appropriato programma oggetto per quel tipo di file
  551.   se vi si clicca due volte sopra o se si selezione "Esegui".
  552. - Premendo "Icona" MTool pu
  553.  creare una opportuna icona per il tipo
  554.   riconosciuto.
  555. E'  quindi  possibile  definire un programma oggetto e una icona oggetto per
  556. ogni tipo di file.
  557. @endnode
  558. @node PR_devs "Elenco Devices"
  559. 3.6 Elenco Devices:
  560. E'  possibile  qui  definire  un  elenco  di devices altenativo.  I nomi qui
  561. immessi  verranno  usati  come  entry  in una lista.  Se selezionerai uno di
  562. questi nomi, MTool mostrer
  563.  il contenuto della directory introdotta in "Nome
  564. Percorso" nella finestra attiva.
  565. @endnode
  566. @node PR_action "Elenco Azioni"
  567. 3.7 Elenco azioni:
  568. Dall'elenco  dei  device  puoi passare a questo premendo al solito il gadget
  569. "Tipo  Oggetto".   Questo  funziona allo stesso modo dell'elenco dei devices
  570. visto  prima:   il nome mostrato nella list view questa volta indica uno dei
  571. programmi oggetto che verranno eseguiti una volta selezionati.
  572. @endnode
  573. @node Usage "Uso di MTool"
  574. 4. Uso di MTool
  575. Se non hai mai usato dei programmi per la manipolazione delle directory come
  576. MTool, 
  577.  meglio dire due parole in generale su questo tipo di utilities.
  578. Come  utente  di  MTool,  dovresti  avere una certa familiarit
  579.  nell'uso del
  580. Workbench e della shell di sistema.
  581. MTool  unisce  le  possibilit
  582.  e la flessibilit
  583.  delle shell con la comodit
  584. nell'uso  del  Workbench.   E' possibile eseguire tutte le operazioni con il
  585. semplice  uso  del  mouse:   copiare files, spostarli, cancellarli, mostrare
  586. disegni, editare testi, e cos
  587.  via...
  588. Dopo aver lanciato MToll dovresti vedere due grandi finestre vuote.  Saranno
  589. le  finestre dove verranno mostrati le liste dei files.  In cima a ognuna di
  590. queste  finestre  c'
  591.  un gadget che accetta delle stringhe, dove comparr
  592. nome  della  directory  attualmente  mostrata sotto.  E' possibile scriverci
  593. direttamente  semplicemente  cliccandoci con il mouse sopra.  Scrivendo cos
  594. direttamente  il  nome  della directory, questa verr
  595.  mostrata.  Al si sotto
  596. delle  liste dei files, c'
  597.  un piccolo box che indica ulteriori informazioni
  598. riguardo  la directory sopra mostrata.  C'
  599.  indicato lo spazio libero ancora
  600. disponibile sul disco, il suo stato ("OK":  tutto a posto, "Prot":  protetto
  601. in scrittura, "Vali":  disco non validato, non 
  602.  permesso scrivere).
  603. In   un  lato  di  questo  box  c'
  604.   un  gadget  con  una  "I"  all'interno.
  605. Selezionandolo  si otterranno ulteriori informazioni sul disco:  la capacit
  606. completa,  il  nome  del  disco,  la lunghezza dei files selezionati e delle
  607. directories.
  608. Selezionando  una  delle  due  liste  dei  files,  la  linea  di stato sotto
  609. quest'ultima  sar
  610.   evidenziata  mentre  l'altra sar
  611.  scura.  Inoltre la
  612. finestra  contenente  la  lista  corrente  aparir
  613.  come premuta all'interno.
  614. Questa  sar
  615.   la  lista dei files attiva.  E' possibile cambiare anche lista
  616. dei files semplicemente premendo "spazio".
  617. @endnode
  618. @node US_dirs "Lista dei files"
  619. 4.1 Operazioni con le liste dei files
  620. Tra le due liste dei files c'
  621.  una colonna di gadget diversi che permettono
  622. di eseguire le operazioni fondamentali di MTool.
  623. In  cima a questa colonna c'
  624.  il gadget "Parent".  Se tu premi su questo, la
  625. lista  dei  file  attiva cambier
  626.  nella directory del livello superiore - la
  627. directory    precedente.     Per    esempio,   se   si   sta   visualizzando
  628. "Workbench:devs/printers"  premendo  "Parent"  si  otterr
  629.   il  contenuto di
  630. "Workbench:devs".   E'  possibile  anche selezionare la directory precedente
  631. cliccando  sul bordo pi
  632.  esterno della listview o premendo il tasto sinistro
  633. tra i tasti cursore.
  634. La  lettera  "P"  del gadget Parent 
  635.  sottolineata.  Questo significa che tu
  636. puoi  anche  selezionare  questo gadget premendo il tasto P.  Lo stesso vale
  637. anche per tutti gli altri gadget che anno una lettera sottolineata.
  638. Subito sotto il gadget parent, c'
  639.  una listview contenente i nomi di tutti i
  640. devices,  tutti  i  dischi disponibili, e anche gli "assegnamenti" fatti sul
  641. tuo  sistema.   Questo  elenco sar
  642.  aggiornato ogni volta che un nuovo disco
  643.  inserito o tolto.
  644. Selezionando  uno di questi nomi, il suo contenuto sar
  645.  mostrato nella lista
  646. dei files attiva.
  647. La  lista dei device pu
  648.  essere usata anche per due ulteriori usi.  Primo, 
  649. possibile  definire  il  proprio  elenco  dei  devices usando l'editor delle
  650. preferenze.    Secondo,   
  651.    possibile   definire   un   elenco  di  azioni
  652. presonalizzato.   Il modo attreverso il quale 
  653.  possibile usare queste liste
  654. personali,  
  655.   premendo il gadget sotto l'elenco stesso.  Oppure premendo il
  656. tasto "`"
  657. @endnode
  658. @node US_Copy "Copia, Cancella..."
  659. 4.2 Copia, Sposta, Cancella, Rinomina and CreaDir
  660. I  primi  tre  gadget sotto l'elenco dei device sono i pi
  661.  importanti per la
  662. moanipolazione  dei  tuoi  dischi  e  dei dati registrati sopra.  Attenzione
  663. anche che tramite questi 
  664.  possibile cancellare uno o pi
  665.  files!
  666. Copia:   Tutti  i files e le directories che sono selezionate nella finestra
  667. attiva  sono copiati nella directory della lista dei files inattiva.  I dati
  668. originali rimangono immutati.  La directories sono copiate con tutto il loro
  669. contenuto.
  670. Sposta:   Idem  coma  Copia,  ma con una grande differenza:  ogni file viene
  671. cancellato dopo essere stato copiato.
  672. Cancella:   Elimina  tutti  i files e le directories (con il loro contenuto)
  673. attualmente  selezionati  nella  finestra  attiva.   Ricordati  che questo 
  674. definitivo:   non c'
  675.  modo immediato per recuperare ci
  676.  che si 
  677.  cancellato,
  678. e ci sono tools come DiskSalv2 e FixDisk che possono aiutarti nel recuperare
  679. dati, ma solo se non sono stati ricoperti da files nuovi...
  680. Ciascuno  di  questi tre gadget porta in primo piano una finestra.  E' usata
  681. per  controllare il modo in cui MTool far
  682.  la copia, canceller
  683.  files e cos
  684. via.   Se  sei  sicuro  di  quello  che  stai  facendo,  premi semplicemente
  685. "Return".   MTool  a  questo  punto  inizier
  686.   il suo lavoro, senza dare pi
  687. possibilit
  688.  di interrompere.
  689. Altrimenti  MTool  ti  mostrer
  690.   alcune  informazioni  sul  file attualmente
  691. trattato,  a  seconda  di  cosa  hai  selezionato nella met
  692.  superiore della
  693. finestra:  Data, dimensione e versione.
  694. Puoi  anche  confrontare  il  file con un altro con lo stesso nome che 
  695. presente  nella  directory inattiva.  Puoi anche decidere se confermare ogni
  696. file,  oppure  se  procedere  senza  ulteriori  controlli con tutti i files,
  697. oppure, nel caso di Copia, se devi essere avvertito nel caso in cui ci siano
  698.  file con lo stesso nome nella directory di destinazione.
  699. Rinomina:  Comparir
  700.  una finestra per ogni file/directory selezionata, nella
  701. quale  potrai  inserire il nuovo nome.  Per uscire da questa fase, chiudi la
  702. finestra con l'apposito gadget.  Selezionando "Cancella" invece eviterai che
  703. MTool rinomini solo il file corrente.
  704. "CreaDir"  premette  di  creare una nuova directory nella lista file attiva.
  705. Nella finestra devi inserire il nome che desideri abbia.
  706. @endnode
  707. @node US_select "Selezioni"
  708. 4.3 Selezioni
  709. I  prossimi  due  gadget sono usati per selezionare alcuni files nella lista
  710. dei files attiva.  "Tutti" seleziona tutti i files, "Nessuno" cancella tutti
  711. quelli selezionati.
  712. Il  piccolo  gadget  "?"  alla  destra  mostra un requester dove 
  713.  possibile
  714. immettere  un pattern di selezione secondo lo standard di AmigaDOS.  Tutti i
  715. files  che  soddisfano questo pattern saranno selezionati o deselezionati...
  716. Nel manuale AmigaDOS c'
  717.  una esauriente descrizione di come usare i patterns
  718. [se non avete un 1200 dovreste averlo NdT :-(].
  719. @endnode
  720. @node US_archiv "Archivia"
  721. 4.4 Archivia
  722. Gli  archivi  sono  files  contenenti  uno  o pi
  723.  files memorizzati in forma
  724. compressa  al loro interno.  Sono soprattutto usati per risparmiare spazio e
  725. tempo  nei  trasferimenti via modem.  Sono anche comodi perch
  726.  permettono di
  727. avere in un unico file pi
  728.  files differnti...
  729. MTool  
  730.   capace di controllare tutte le funzioni standard dell'archiviatore
  731. "LHA".   LHA  deve  essere  presente  nel tuo sistema e il suo percorso deve
  732. essere configurato correttamente tramite le preferenze.
  733. 4.4.1 Creazione di nuovi archivi:
  734. Se vuoi creare dei nuovi archivi, comportati come se volessi copiare i files
  735. o  le  directory che intendi compattare, selezionando quali vuoi archiviare.
  736. Poi, al posto di selezionare "Copia", premi "Archivia".  Ti verr
  737.  chiesto il
  738. nome dell'archivio, dopodich
  739.  tutti i file seleizionati e le directories con
  740. i  loro  files  all'interno saranno compressi in un grande archivio che sar
  741. messo  nella finestra della lista dei files inattiva, lasciando ovviamente i
  742. files originari intatti.
  743. 4.4.2  Scompattazione  degli  archivi,  cancellazione  parziale,  o aggiunta
  744.        files:
  745. Se  invece  hai  ga
  746.   un archivio a tua disposizione e vuoi lavorarci sopra,
  747. puoi semplicemente cliccare due volte sul suo nome.  MTool a questo punto ti
  748. mostrer
  749.   il  contenuto dell'archivio con tutte le sue sottodirectories.  Le
  750. sottodirectories  non sono mostrate come tali, e tutti i files sono mostrati
  751. con il loro percorso completo.
  752. A  questo  punto  tu puoi trattare questi come un qualunque elenco di files:
  753. Copia, Sposta, Cancella, ecc.
  754. Attenzione   che   MTool   si   rifiuta   di   lavorare   su   due   archivi
  755. contemporaneamente  in quanto copiare file da un archivio all'altro 
  756.  troppo
  757. complicato  e  non supportato da LHA.  Per fare ci
  758.  basta scompattare in una
  759. directory  temporanea  (RAM:  per esempio) e quindi copiare i file nel nuovo
  760. archivio.
  761. Alcune  azioni  non sono permesse in un archivio, per cui i loro gadget sono
  762. mascherati, fino a che un archivio 
  763.  presente nella finestra attiva.
  764. @endnode
  765. @node US_analyze "Analizza ed Esegui"
  766. 4.5 Analizza and Esegui
  767. Puoi  far  analizzare a MTool i file selezionati (non le directory) premendo
  768. il  gadget  "Analizza".  La finestra che nascer
  769.  mostrer
  770.  il nome del file e
  771. un  elenco di informazioni che MTool riconosce riguardo a quel file, sia per
  772. quel  che  riguarda  la sua definizione come oggetto, o dal codice interno a
  773. MTool.
  774. Sulla destra puoi vedere come sia possibile monipolare i flags di protezione
  775. del  file.   Saranno  memorizzati  solo  se non esci dalla finestra premendo
  776. "Cancella".
  777. Esegui:   Cerca  di  fare  qualche  cosa di utila con il file.  Normalmente,
  778.   lanciato  un  programma  (per  esempio  uno  in grado di mostrare dei
  779. disegni...).
  780. Ci  sono  altri due modi di far eseguire a MTool delle azioni senza usare la
  781. finestra  di  "analizza".   Cliccando due volte sul nome del file o premendo
  782. direttamente  il  gadget "Esegui".  Nel primo caso, solo il file vittima del
  783. doppio  click  subir
  784.  l'azione.  Nel secondo invece tutti i file selezionati
  785. verranno  esaminati  e  usati.   Al  momento  "Esegui"  lavora con i file di
  786. testo/ASCII  e  con  gli archivi creati con LHA se MTool 
  787.  stato configurato
  788. correttamente.   E'   possibile  ovviamente  definire  altri  tipi  di  file
  789. attraverso la preferenze.
  790. @endnode
  791. @node US_menu "Menu"
  792. 4.6 Menu
  793. Ci  sono  due  funzioni  principali per il menu.  E' possibile richiamare il
  794. programma  per settare le preferenze oppure puoi includere programmi esterni
  795. nel menu "Strumenti".  L'ultima cosa sar
  796.  spiegata pi
  797.  avanti.
  798. Nel   menu   "Progetto"  sono  presenti  dei  comandi  per  mostrare  alcune
  799. informazioni  riguardo  a MTool e per uscire dal programma.  Si pu
  800.  ottenere
  801. lo stesso risulato con Amiga-E oppure con ESC.
  802. Con  "Nascondi" chiuderai temporaneamente le finestre e lo schermo di MTool.
  803. si  riapriranno  nelle  stesse  condizioni  rilanciando MTool o premendo gli
  804. hotkey  (di  defaul  sono  Ctrl Alt "<") o attraverso il programma exchanges
  805. delle commodities.
  806. Il  menu  "Preferenze"  
  807.   usato  per  caricare  il  files,  per lanciare il
  808. programma di preferenze, e per settare due importanti modi di funzionamento:
  809. "Schermo Proprio" salta tra lo schermo di MTool e quello del Workbench.
  810. "AutoDir"  abilita  invece l'aggiornamento automatico dell'elenco dei device
  811. quando  un  disco  viene cambiato o estratto.  Anche la lista dei files sar
  812. modificato di conseguenza (se necessario).
  813. Come  detto  prima  il  menu  "Strumenti" pu
  814.  contenere programmi aggiuntivi
  815. richiamabili da MTool e settabili attraverso il programma delle preferenze.
  816. @endnode
  817. @node US_icon "Icone"
  818. 4.7 Icone
  819. MTool  pu
  820.  creare una icona per ciascun file selezionato.  Per far ci
  821. , deve
  822. essere  stato  definito  attraverso le preferenze un file type e quindi aver
  823. definito una icona per quel tipo di file.  Per aggiungere una icona a questo
  824. punto basta selezionare il file e premere "Icona" e MTool far
  825.  il resto.
  826. @endnode
  827. @node US_rest "Altre Features"
  828. 4.8 Altre Features
  829. 4.8.1 Controllo attraverso la tastiera
  830. Fin  dall  versione  1.3  MTool permette di accedere a tutte le sue funzioni
  831. attraverso  la  tastiera.  I tasti pi
  832.  utili da questo punto di vista sono i
  833. tasti cursore che permettono di muoversi nell'elenco dei file.  E' possibile
  834. riconoscere  il  file  sul  quale  si  sta  operando perch
  835.  mostrato in
  836. grassetto.   Il  tasto  "cursore  a sinistra" opera come il gadget "Parent",
  837. mentre  "Cursore  a  destra"  si  comporta  come  "Esegui"  sull'ingresso in
  838. grassetto,  tranne nel caso in cui sia una directory, nel qual caso MTool vi
  839. entrer
  840.   dentro.   Questo  tipo  di interfaccia coincide con quella del file
  841. requester  MFR  di  Stefan  Stunz.   Mantenendo  premuto  il tasto "SHIFT" e
  842. premendo  il  cursore  verso l'alto o il basso, coincider
  843.  con una selezione
  844. del file precedente.  Tramite il tasto "ALT" si ottiene una deselezione.  E'
  845. possibile  cambiare  lista  dei  files attiva attraverso il tasto "SPAZIO" e
  846. tramite  "Return"  si  seleziona  la  finestra dove 
  847.  presente il nome della
  848. direcotry mostrata in testa all'elenco dei files.
  849. Il  controllo  dell'elenco  dei  device funziona allo stesso moso.  Il tasto
  850. "DEL"  attiva l'elenco dei device, con "Su"/"Gi
  851. " si muove il cursore mentre
  852. con "sinistra"/"destra" si visualizza il contenuto del device nella finestra
  853. di  sinistra/destra.   I  differenti  usi  della finestra dei device possono
  854. essere attraversati con il tasto "`" (accento grave ?  NdT).
  855. 4.8.2 Commodity
  856. Il supporto delle commodity 
  857.  stato aggiunto a MTool fin dalla versione 1.5.
  858. Questo  ha  permesso  di  aggiungere  anche  un  nuovo  ingresso tra i menu:
  859. "Nascondi".  Selezionandolo, MTool chiuder
  860.  tutte le sue finestre e schermo,
  861. ma  rimarr
  862.   in  memoria  pronto  a  essere richiamato.  Per fare ci
  863. , premi
  864. l'hotkey  (di default 
  865.  ctrl alt "<") oppure usa il programma exchange delle
  866. commodities,  o  rilancia  MTool  una  seconda volta.  E' possibile cambiare
  867. l'hotkey   inserendo   in   "CX_POPKEY=  nuova  combinazione"  nei  tooltype
  868. dell'icona di MTool, o passandolo come parametro della shell.  "CX_POPUP=no"
  869. permette  a MTool di non aprire la sua finestra una volta lanciato.  E' cos
  870. possibile lanciare MTool automaticamente all'avvio del sistema attraverso il
  871. cassetto WBstartup e averlo pronto alla pressione di tre tasti :)
  872. 4.8.3 Appwindow
  873.   un  modo  molto  efficiente  di  mostrare  le directories in MTool se 
  874. lanciato  nello  schemo  del Worbench.  Semplicemente trascina una directory
  875. all'interno  di  una  finestra  di  MTool...  Il suo contenuto sar
  876.  mostrato
  877. esattamente come se avessi selezionato tutti i percorsi intermedi.  Funziona
  878. anche con pi
  879.  files selezionati.
  880. 4.8.4 Features Speciali
  881. - Il programma per editare le preferenze si apre sempre sullo stesso schermo
  882.   di  MTool  se  
  883.  possibile.  Ogni  cambiamento fatto  alle  preferenze  si
  884.   ripercuote immediatamente in MTool.
  885. - Mentre aspetta  che tu faccia qualche cosa,  MTool controlla che nulla sia
  886.   cambiato nelle directories mostrate delle due liste dei files. Se qualcosa
  887.   cambitato,  MTool  aggiorna  il tutto.  Questo 
  888.   fatto  attraverso  la
  889.   funzione "notify" del S.O. che non consuma tempo macchina.
  890. - Le directories sono rilette solo se sono realmente cambiate.
  891. - E'  possibile  cambiare il settaggio del requester di copia durante il suo
  892.   lavoro, causando una interruzione. E' possibile proseguire usando "Start".
  893. - Mentr e  si   stanno   rinominando   molti  files,   
  894.   possibile   uscire
  895.   semplicemente chiudendo il requester.
  896. - I  gadget con doppio bordo  possono essere attivati premendo semplicemente
  897.   "Return"
  898. @endnode
  899.